.. _cecClearOne:

cecClearOne
===========
-----------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 cecClearOne(
    VT_I4 Channel
  )



DESCRIPTION
-----------


- 대상 카운터 채널의 카운트 값을 Clear (0 으로 리셋) 시킵니다.



PARAMETER
---------


- Channel : cecClearOne 함수의 인자로서 채널 번호. 통합 채널로 관리되는 채널 번호를 의미하며,. 상수 값으로 0 (Zero Based) 이상, (최대 통합 채널수 - 1) 이하의 값을 채널 번호로 설정할 수 있습니다. 




RETURN VALUE
------------


+----------------+-------------------------------------------------------+
| Value          | Meaning                                               |
+================+=======================================================+
| 음수           | 수행 실패. 자세한 내용은 '에러 처리' 편을 참고합니다. |
+----------------+-------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공                                             |
+----------------+-------------------------------------------------------+


EXAMPLE
`````````````

.. code-block:: cpp
 :linenos:

 C/C++
 #include “ceSDK.h”
 #include “ceSDKDef.h”
 long nCntChNo = 1; // 단일 카운터 채널 번호
 long nCntIniChNo = 0; // 카운터 시작 채널 번호
 long nCntChNum = 4; // 카운터 채널 개수
 long nNodeID = 1; // 원격 노드 ID. 카운터 모듈이 속한 원격 노드의 ID
 // 단일 카운트 채널의 카운트 값을 0 으로 Clear 합니다.
 if ( cecClearOne ( nCntChNo ) != ceERR_NONE )
 {
  OutputDebugString ( "cecClearOne has been failed" );
 }
 // 0 ~ 3 번 카운트 채널의 카운트 값을 0 으로 Clear 합니다.
 if ( cecClearMulti ( nCntChNo, nCntChNum ) != ceERR_NONE )
 {
 OutputDebugString ( "cecClearMulti has been failed" );
 }
 // 해당 원격 노드 내의 모든 카운트 채널에 대해 카운트 값을 0 으로 Clear 합니다.
 if ( cecClearAll ( nNodeID ) != ceERR_NONE )
 {
 OutputDebugString ( "cecClearAll has been failed" );
 }